home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / vgb206b1.zip / VGB.DOC < prev    next >
Text File  |  1996-04-29  |  18KB  |  412 lines
  1.  
  2.  
  3.                    ******* Virtual GameBoy *******
  4.                 The Portable Nintendo GameBoy Emulator
  5.                              version 0.6
  6.  
  7.                          by Marat Fayzullin
  8.                       
  9.                       email: fms@freeflight.com
  10.                             IRC:  RST38h
  11.                  WWW: http://www.freeflight.com/fms/
  12.  
  13.          (*) GameBoy is a registered trademark of Nintendo.
  14.  
  15.  
  16.  
  17.                        * NEW IN THIS VERSION *
  18.  
  19. o Several bugs fixed in CPU emulation
  20. o CPU emulation now accesses memory via pointers which makes it slower, 
  21.   but page switcihing takes much less time
  22. o GameGenie cheats can now be used
  23. o A check for NOP;JP sequence at 0100h is removed
  24. o LCD controller emulation is slightly corrected
  25. o Makefile now contains comments on compiling VGB
  26. o New debugger is added, thanks to Pascal Felber
  27. o Sprite priorities are *not* implemented yet
  28.  
  29.  
  30.  
  31.                           * INTRODUCTION *
  32.  
  33.   Please, *carefully* read this manual. Do not write me email with
  34. questions answered in here, as such letters are going to be ignored: I
  35. have too many other things to do to answer the same questions over and
  36. over again.
  37.   *Windows users* will find a special section downgraded in content for
  38. better comprehension. 
  39.  
  40.   Virtual GameBoy [VGB] is a portable emulator of the Nintendo GameBoy
  41. handheld videogame console written in C. Although many things do not work
  42. quite well yet, it was able to run about 85% of games checked with it. You
  43. can always get the latest VGB source code, binaries, and support files
  44. from
  45.  
  46.                   http://www.freeflight.com/fms/VGB/
  47.  
  48. Another GameBoy-related archive is at
  49.  
  50.                   ftp://altair.komkon.com/pub/GameBoy/
  51.  
  52.   There are versions of VGB for Amiga, Macintosh, and IBM PC [both
  53. MeSsyDOS and Windoze]. Following people are maintaining ports of VGB to
  54. these systems: 
  55.  
  56. MSDOS:      Marcel de Kogel [m.dekogel@student.utwente.nl]
  57. Windows:    Marat Fayzullin [fms@wam.umd.edu]
  58. Macintosh:  John Stiles [jstiles@cello.gina.calstate.edu]
  59.  
  60.   If you would like to port VGB to another system, or make changes in
  61. VGB's code *please*, contact me by email or some other means. Note, that
  62. VGB source code is freely distributable, but it is *not* public domain.
  63. You can not use it in commercial purposes unless you contact me to arrange
  64. the conditions of such usage and get my permission. Feel free to look at
  65. existing drivers as well as at other code. More explanations follow.
  66.  
  67.   This manual covers two different VGB distributions:
  68.  
  69. 1. *** Source Code Distribution ***
  70.   This distribution contains C sources of the emulator, and the
  71. screen/keyboard drivers for Unix/X. Virtual GameBoy has been tested on the
  72. following Unix systems: 
  73.  
  74.   SunOS   Solaris   OSF/1   FreeBSD   HP/UX   Linux   AIX
  75.  
  76. 2. *** VGB-Windows Distribution ***
  77.   Due to the flood of requests from the people who use DOS/Windows running
  78. PCs and are unable to compile the emulator on their own, I have ported VGB
  79. under Microsoft Windows. This distribution contains an executable of a
  80. limited version of VGB-Windows which doesn't allow you to reload a new
  81. game from a menu when emulation is already running, and has an annoying
  82. "Virtual GameBoy DEMO" message across its window. The uncrippled version
  83. of VGB-Windows is available for $35US from
  84.  
  85.   Marat Fayzullin
  86.   6304 Hampton Place
  87.   Elkridge, MD 21227
  88.   USA
  89.  
  90.   VGB-Windows is a 32-bit application which runs under Windows 3.11, 
  91. Windows 95, and Windows NT. It is compiled with Borland C++ and needs 
  92. Microsoft WinG library which can be obtained from
  93.  
  94.   ftp://ftp.microsoft.com/Softlib/MSFILES/WING10.EXE
  95.  
  96.   Windows 3.xx users will also require Win32s library available from
  97.  
  98.   ftp://ftp.microsoft.com/Softlib/MSLFILES/PW1118.EXE
  99.  
  100.  
  101.  
  102.                * SHORT MANUAL FOR THE WINDOWS USERS *
  103.  
  104.   In order to use VGB-Windows, you will first have to install WinG
  105. graphical library which can be obtained from Microsoft [see address
  106. above]. If you have Windows 3.xx, you may also need to install Win32s
  107. extension libraries whose address is also given above. Also, the
  108. VGB-Windows distribution contains a file called BWCC32.DLL which should be
  109. either kept in a directory from which VGB runs, or copied into
  110. \WINDOWS\SYSTEM directory. 
  111.   VGB-Windows runs in a resizable window with the following menus:
  112.  
  113. o File
  114.   o New
  115.     This opton allows to run a new game. If you only have an unregistered
  116.     version of VGB-Windows, it will be disabled so that you will only be
  117.     able to choose a game when emulator starts.
  118.   o Setup
  119.     This option pops up a setup dialog allowing to change all 4 GameBoy's
  120.     colors and some emulation parameters:
  121.     o Palette
  122.       Use this group of controls to select a color and change its RGB
  123.       components. The palette controls may not work very well if you
  124.       run Windows in 256-color mode. Use 16-bit or 24-bit graphical
  125.       mode for best effect. 
  126.     o VBlank Period
  127.       This parameter determines how many CPU commands will be executed
  128.       between vertical blanking interrupts. Setting it lower may speed
  129.       up the emulation, but setting it too low will hang it.
  130.     o Update Period
  131.       This parameter determines how many vertical blanking interrupts
  132.       will pass between window refreshes. It is usually set to 2, but
  133.       you can increase it to make VGB work faster. The sprite
  134.       movements become jerky at high update periods though, and some
  135.       sprites may simply disappear.
  136.     o Delay Line Interrupts
  137.       If you see "dirty" horizontal lines in some games, you may turn
  138.       this option on or off to remove them. There is no some universal
  139.       state of this option which will work for all games though.  
  140.     o Check CRC
  141.       With this switch off, VGB will not check the control sums of
  142.       the loaded cartridges.
  143.     o Save CPU
  144.       With this switch on, VGB will suspend the execution when its
  145.       window is inactive.
  146.     o Autofire A
  147.       Turn this on to make the [A] button generate series of keypresses
  148.       instead of a single keypress.
  149.     o Autofire B
  150.       Turn this on to make the [B] button generate series of keypresses
  151.       instead of a single keypress.
  152.   o Quit
  153.     Quit the emulation. A .SAV file will be saved if the game has a
  154.     battery-backed RAM.
  155. o Size
  156.   o 1:1  These options change the window size to be the same as in real
  157.   o 2:1  GameBoy, or 2/3/4 times bigger. Please, note that you can change
  158.   o 3:1  window size by simple dragging the bottom-right corner of a
  159.   o 4:1  window with the mouse.
  160. o Help
  161.   o About
  162.     This option will display a dialog box with copyright information
  163.     and other legal stuff.
  164.  
  165.  
  166.  
  167.                    * FREQUENTLY ASKED QUESTIONS *
  168.  
  169. 1. What is GameBoy?
  170.   GameBoy is a handheld videogame machine produced by Nintendo. It is
  171. built around a custom CPU similar to Z80, but with some changes. GameBoy
  172. is frequently laughed at because of its reflective green-on-yellow LCD
  173. screen which in fact is its virtue. Due to the low power consumption of
  174. its LCD, GameBoy can work for 35 hours off 4 AA batteries. There is a lot
  175. of good games produced for GameBoy, both classics [Tetris, Pacman,
  176. Asteroids, etc.] and specific ones [Final Fantasy series for GB]. It
  177. excells in RPGs and classic games where gameplay is more important than
  178. graphics. More information about GameBoy is available from
  179.  
  180.            http://www.freeflight.com/fms/GameBoy/
  181.  
  182. 2. Where do I get GameBoy games?
  183.   You buy the cartridges. GameBoy software is copyrighted and still sold. 
  184. Therefore, its distribution is an act of piracy. Nothing prohibits you 
  185. from backing up a cartridge you own and playing it on the emulator though.
  186. To back up a GameBoy cartridge, you can use either SmartCard copier [about
  187. $100 for a standalone version], or a self-built copier designed by Pascal 
  188. Felber, description of which is available at
  189.  
  190.            http://www.freeflight.com/fms/GameBoy/
  191.  
  192. Please, DO NOT SEND ME MAIL ASKING TO SEND YOU THE CARTRIDGE FILES OR TELL
  193. YOU WHERE TO FIND THEM. I ignore such letters. 
  194.  
  195. 3. Where is the complete list of command line options of VGB?
  196.   Use -help option. It will tell VGB to display all options available in 
  197. your version. Following are the currently available options:
  198.  
  199.   -ver